Paiements ACH

Swagger

Notre interface API Paiements ACH est un moyen rapide et économique d'envoyer et de percevoir des paiements nationaux et internationaux depuis les États-Unis. Vous pouvez soumettre des lots comprenant jusqu'à 200 paiements à tout moment et les suivre grâce à des mises à jour en temps réel.

Aperçu

Limites :	99 999 999 $/paiement 200 paiements/appel (doivent être tous des débits ou tous des crédits) Jusqu'à 60 jours à l'avance Appels illimités
Pays :	États-Unis, Mexique et Panama USD uniquement (conversion en devises locales à la destination)
Vitesse :	Le jour même (disponible jusqu'à 14 h 00 HC pour les paiements aux États-Unis) 2 jours ouvrables (ACH standard et IAT)
Heures limites (jours ouvrables) :	Paiements ACH le jour même 14 h 00 HC Paiements AC standards et IAT 20 h 00 HC

Vue rapprochée

Paiements en masse économiques – Vous pouvez regrouper jusqu'à 200 paiements en un seul appel et réaliser des économies. Les paiements en lot doivent être du même type.

Envoi immédiat ou plus tard – Vous pouvez envoyer des paiements le jour même ou les programmer jusqu'à 60 jours à l'avance. Les paiements en masse peuvent avoir des dates de traitement différentes.

Traitement séparé – Les paiements envoyés ou perçus n'apparaissent pas dans les Services bancaires en ligne pour entreprises et ne peuvent pas être modifiés une fois soumis. Toutefois, les suppressions et les renversements sont possibles dans le service ACH Fraud Control.

Suivi en temps réel – Demandez des mises à jour sur l'état de vos paiements créés ou recevez des alertes automatiques par API, courriel ou message texte à l'aide de notre interface API Notifications push. Les paiements sont suivis jusqu'à leur départ de BMO, mais les problèmes potentiels à l'autre banque sont également couverts.

Rapprochement facile – Vous pouvez vous abonner à un rapport automatique de fin de journée indiquant les transactions individuelles qui ont été compensées par une entrée de règlement consolidée générée PEP+. Cela vous permet de rapprocher facilement les règlements ACH avec leurs entrées ACH individuelles.

Endpoints Summary

post

/tpp/ach/payment-initiation/customer-credit-transfer-initiation

Send Payment Credit

post

/tpp/ach/payment-initiation/customer-direct-debit-initiation

Send Payment Debit

post

/tpp/ach/payment-initiation/get-transaction-status/get

Obtain Payment Status

post

/tpp/ach/customer-access-entitlement/commercial-user-access-arrangement/get

Get Company ID List

Chiffrement de la charge utile

Pour des raisons de sécurité, toutes les demandes envoyées à nos interfaces API de paiement et toutes les réponses provenant de celles-ci doivent être chiffrées. Pour obtenir des instructions détaillées, consultez notre processus de chiffrement.

Voir la documentation sur le chiffrement

Envoyer des paiements

Pour réduire le nombre d'appels nécessaires, vous pouvez soumettre un ou plusieurs lots comprenant au total jusqu'à 200 paiements dans le cadre d'un même appel. Ceux-ci doivent tous être des crédits, mais vous pouvez inclure à la fois des paiements actuels et des paiements prévus (jusqu'à 60 jours à l'avance).

Créez vos paiements (Pain.001) en indiquant le type et toutes les informations obligatoires, comme indiqué dans le document « Spécifications » en haut de la page. Nous vous recommandons d'envoyer d'abord une transaction préliminaire de 0 $ et de confirmer l'état du paiement avant d'envoyer le montant réel. Notre interface API prend en charge les transactions préliminaires de 0 $ et les micro-dépôts de moins de 1 $, mais elles doivent être soumises en tant que transactions indépendantes. Pour plus de sécurité, nous vous recommandons également d'utiliser notre interface API Validation de compte.

Une fois soumis, nous validerons vos paiements et nous vous communiquerons les résultats (Pain.002). Si tout est en ordre, nous traiterons vos paiements. Aucune autorisation n'est requise.

Remarque : Les paiements n'apparaissent pas dans les Services bancaires en ligne pour entreprises et ne peuvent pas être modifiés une fois soumis. Cependant, les suppressions et les annulations sont possibles dans ACH Fraud Control.

Post

/tpp/ach/payment-initiation/customer-credit-transfer-initiation

Essayez-le

Request

Code Samples

Headers

x-fapi-interaction-id required

string

x-fapi-customer-last-logged-time

string

x-fapi-customer-ip-address

string

x-fapi-customer-user-agent

string

x-fapi-financial-id

string

x-crypto-key

string

x-request-id required

string

x-sourcesystem-id

string

x-api-key

string

x-app-cat-id

string

x-csrf-token

string

x-content-type

string

x-expires

string

x-cache-control

string

x-content-disposition

string

Body

Response

Table JSON

ResponsePayload { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Percevoir des paiements

Vous pouvez également percevoir vos paiements en masse pour réduire le nombre d'appels nécessaires. Vous pouvez soumettre un ou plusieurs lots comprenant au total jusqu'à 200 paiements dans le cadre d'un même appel. Ceux-ci doivent tous être des débits, mais vous pouvez inclure à la fois des paiements actuels et des paiements prévus (jusqu'à 60 jours à l'avance).

Créez vos paiements (Pain.008) en indiquant le type et toutes les informations obligatoires, comme indiqué dans le document « Spécifications » en haut de la page. Il est nécessaire de soumettre d'abord une transaction préliminaire de 0 $ et de confirmer l'état du paiement avant de percevoir le montant réel. Notre interface API prend en charge les transactions préliminaires de 0 $ et les micro-dépôts de moins de 1 $, mais elles doivent être soumises en tant que transactions indépendantes. Pour plus de sécurité, nous vous recommandons également d'utiliser notre interface API Validation de compte.

Une fois soumis, nous validerons vos paiements et nous vous communiquerons les résultats (Pain.002). Si tout est en ordre, nous traiterons vos paiements. Aucune autorisation n'est requise.

Post

/tpp/ach/payment-initiation/customer-direct-debit-initiation

Essayez-le

Request

Code Samples

Headers

x-fapi-interaction-id required

string

x-fapi-customer-last-logged-time

string

x-fapi-customer-ip-address

string

x-fapi-customer-user-agent

string

x-fapi-financial-id

string

x-crypto-key

string

x-request-id required

string

x-sourcesystem-id

string

x-api-key

string

x-app-cat-id

string

x-csrf-token

string

x-content-type

string

x-expires

string

x-cache-control

string

x-content-disposition

string

Body

Response

Table JSON

ResponsePayload { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Obtenir l'état du paiement

Vérifiez le dernier état de vos paiements envoyés (CAMT.005). Cet appel renvoie l'état actuel d'un lot de paiements particulier (Pain.002) jusqu'à ce qu'il quitte BMO. Veuillez consulter le tableau ci-dessous pour plus d'informations sur les états possibles qui peuvent être renvoyés.

Remarque : Au lieu de vérifier manuellement, vous pouvez également demander des alertes automatiques par API Webhook, courriel ou message texte à l'aide de notre interface API Notifications push.

Post

/tpp/ach/payment-initiation/get-transaction-status/get

Essayez-le

Request

Code Samples

Headers

x-fapi-interaction-id required

string

x-fapi-customer-last-logged-time

string

x-fapi-customer-ip-address

string

x-fapi-customer-user-agent

string

x-fapi-financial-id

string

x-crypto-key

string

x-request-id required

string

x-sourcesystem-id

string

x-api-key

string

x-app-cat-id

string

x-csrf-token

string

x-content-type

string

x-expires

string

x-cache-control

string

x-content-disposition

string

Body

Response

Table JSON

ResponsePayload { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Obtenir les ACH Company IDs

Les ACH Company IDs servent d'alias pour vos comptes BMO et les types de paiement ACH pouvant être utilisés. Il s'agit d'un appel facultatif permettant de récupérer la liste des ACH Company IDs disponibles qui ont reçu l'autorisation d'utiliser l'interface API en format .json.

Remarque : Ce point de terminaison n'est actuellement pas disponible pour les tests dans nos environnements bac à sable et préproduction.

Request

Code Samples

Headers

x-fapi-interaction-id required

string

x-fapi-customer-last-logged-time

string

x-fapi-customer-ip-address

string

x-fapi-customer-user-agent

string

x-fapi-financial-id

string

x-crypto-key

string

x-request-id required

string

x-sourcesystem-id required

string

x-api-key

string

x-app-cat-id

string

x-csrf-token

string

x-content-type

string

x-expires

string

x-cache-control

string

x-content-disposition

string

Body

Response

Table JSON

ResponsePayload { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}

Problem { . . .}

}