Paiements ACH

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 du même type) 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

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

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 lot de 200 paiements maximum au cours d'un même appel. Ceux-ci doivent être du même type (crédits ACH ou crédits IAT), mais vous pouvez mélanger les paiements courants et les 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 un lot de 200 paiements maximum au cours d'un même appel pour réduire le nombre d'appels nécessaires. Ceux-ci doivent être du même type (débits ACH ou débits IAT), mais vous pouvez mélanger les paiements courants et les 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 { . . .}

}